home *** CD-ROM | disk | FTP | other *** search
/ L' Effet Pommier 3 / L'Effet Pommier - Volume 03.iso / Graphismes / 3D / PatchDance 0.4.2b4 / READ ME < prev    next >
Text File  |  1996-01-19  |  18KB  |  278 lines

  1. Read Me for PatchDance v0.4.2b4
  2.  
  3. Welcome to PatchDance! 
  4.  
  5.     This release follows v0.4b2.  There are several new features, and a number of old ones now work or work better.  Read the change summary at the end of this file for a list.  A few interim bug-fixes were given out:  if you have one, you may have already seen some of the new features.
  6.     Work is continuing on several features, notably booleans and QuickDraw 3D texture mapping.  There will probably be at least one more general release prior to v0.5 (scheduled to add animation);  this is due to the many requests for more modeling features.
  7. Based on in-house testing and the relatively few problems reported (and now fixed) with previous versions, we believe PatchDance v0.4b4 to be as stable as a lot of commercial software.  We are anxious for any information to the contrary:  in most cases, the program either runs almost perfectly or not at all.  Please help us try to figure out any remaining problems you find.
  8.     A plugin for Adobe Illustrator¬ 5.5 to allow importing our files directly is is available by e-mail to anyone who wants it.
  9.     NEW:  Check our new web page at <http://users.aol.com/PatchDance/Home.html>.
  10. This will always have the latest release and news.
  11.  
  12.     Please look over the Manual.  The program is designed to be easy to learn, but 3D software is inherently complicated (or likely useless.)  Even if you have a lot of prior experience, it is important to read at least the first few sections (marked ╥DON╒T SKIP THIS!╙) because they contain important definitions and interface basics.
  13.  
  14. Inoperative features/limitations:
  15. -    No high quality imaging (QuickDraw 3D preview rendering is available).
  16. -    The Rulers are fully functional but not cosmetically complete.
  17. -    Booleans (surface trim) are still disabled.
  18. -    Interactive lathing with the Rotator (R) does not draw ghosted arcs - 
  19.     not impossible, just a     pain.  Complain loudly if you need this.
  20. -    Documentation is still in draft form.
  21. -    QuickDraw 3D support has several limitations.  See the Manual.
  22.  
  23. Known problems:
  24. -    Crashes:  They happen from time to time!  Please let us know if any specific
  25.     (reproducible)     actions cause one.  Trouble getting the program to run at
  26.     all or more than a crash or two per day is NOT NORMAL, and we╒d like the chance
  27.     to figure out what is wrong.
  28. -    Ongoing problems with QuickDraw 3D (NURBS) on highly curved, 3 sided patches
  29.     (odd distortions).  Much improved in this release but not perfect yet.
  30. -    WARNING:  We have seen occasional crashes that were preceded by odd menu
  31.     behavior.  Usually, the area under a menu is not redrawn until the mouse is released,
  32.     leaving a white space if you move to a different menu.  If you see this, SAVE AT
  33.     ONCE (it usually works).  If you can find a reproducible action that causes it
  34.     (it may involve the QD3D Camera view) we╒d really like to know about it!
  35. -    Occasional failures to read floating point numbers from edit fields.  Usually
  36.     results in a ╥Bad Options╙ alert.  This is believed to be due to a MacOS problem,
  37.     let us know if you find a reproducible case.
  38.  
  39.  
  40. System requirements:
  41. -    Power Macintosh only.  Should work with all PowerPC upgrade cards, clones,
  42.     and PowerPC 601/3/4 systems.
  43. -    3MB of free RAM (minimum).  The Preferred Size of 8MB (or more) provides
  44.     much better performance and is STRONGLY recommended.  QuickDraw 3D
  45.     requires 16MB minimum, and this leaves fairly little memory for other
  46.     applications.  (Though not officially supported by Apple, QuickDraw 3D has been
  47.     operated successfully in 8MB using RAM Doubler.  Contact Tech Support for more
  48.     information.)
  49. -    System 7.5.1 or later is recommended for best performance.  System 7.1.2
  50.     should work but is not guaranteed.  See System Notes below.
  51. -    8 bit color and VRAM video give the best results.  Fewer colors will run but
  52.     cause display problems, more just slows things down. 
  53. -    Won╒t work under Copland.  If you have that, send us a copy and we╒ll gladly fix things up.
  54.  
  55. Installation:
  56. -    Simply copy the application to your hard disk and run it!  Version 0.5 does not
  57.     yet support plugins, so there are no other files to worry about.
  58. -    PatchDance creates a Preferences File in the System (Preferences) Folder when
  59.     its default settings are changed AND set as new defaults.   Deleting this file has
  60.     no effect other than restoring factory defaults.
  61.  
  62. System Notes - Additional information for System Requirements above.
  63. -    The program has been tested successfully under System 7.5.1 with a 3MB partition.
  64.     Performance was drastically affected, and this is considered the bare minimum.
  65.     Monitor the Free Memory readout closely under these conditions (see the Manual, under
  66.     General Dialog.)  Recovering safely from all possible out-of-memory problems is
  67.     very hard to guarantee, and we don╒t (yet).
  68. -    As usual, avoid using Virtual Memory to make up for insufficient RAM.
  69.     VM slows down the system;  this can be improved by code tuning, but probably
  70.     won╒t be for a while yet (until the code is nearly complete).
  71. -    There are no known extension or hardware conflicts:  please report any that
  72.     you discover or suspect.
  73. -    System 7.1.2 users ONLY:  You will have to install the Drag Manager and the
  74.     Thread Manager (v2.0 or later) extensions.  You will also need ObjectSupportLib.
  75.     Contact Tech Support if you have questions.
  76. -    Later versions of MathLib (rather than the original ROM-based one) will improve
  77.     performance.  This is available (free) as part of System 7.5.1.
  78. -    Antivirus software should have no effect on installation or operation.
  79.  
  80. Registration / Tech Support:  PatchDance@aol.com
  81.     You are encouraged to register.  (Not required, no charge, no form needed, just
  82. e-mail.)  Feel free to look us over first and send along your comments / bug list.
  83. It also gets you on our mailing list.
  84.     Tech Support is available via e-mail, direct from the programmer.  Every effort
  85. will be made to reply promptly, but we cannot promise same day service.  Posting
  86. to these lists may be our only acknowledgement when we have  no questions and
  87. immediate rescue is not required.
  88.     Comments and suggestions are very welcome (provided that they minimize personal
  89. insults, etc.)  We aim to please, and we are NOT too proud to make changes if they
  90. improve the product (but there are limits to what can be done!)
  91.  
  92. Upcoming Events:
  93.     Version 0.5b0 begins adding animation.  Also expect ongoing improvements to DXF
  94. and QuickDraw 3D file support.  Basic QuickDraw 3D texture mapping is also on tap
  95. for the next release.
  96.     We are working hard to provide boolean operations (actually, a type of Trim).  This
  97. has proved to be by far the most difficult part of the program:  the design spec calls
  98. for creating editable splines rather than (relatively easy) polygons.  We fully realize
  99. how badly everyone wants this, and we╒re doing the best we can.
  100.     PatchDance has a slightly unusual interface in several respects.  We╒ve added a (basic)
  101. online help system, with improvements coming.  We are also working on a new Preference
  102. to modify certain controls to be more ╥Mac-like╙ where existing methods seem to be
  103. causing confusion.
  104.     Files created by v0.4b0 and earlier are now obsolete:  v0.4b can read and convert
  105. them, but v0.5 may not.  The new format (icons have not changed) is slightly faster in
  106. operation and supports (eventually) file merging and libraries.
  107.  
  108.  
  109.  
  110. Legal Stuff
  111.     PatchDance and all its documentation is copyright 1994-1995 by Paul Sexton.  All rights reserved.
  112.     This application (prior to release of v1.0 at least) is FREE.  It may be given away freely;
  113. for mass distribution, please e-mail PatchDance.@aol.com for permission and latest version
  114. information.   Permission is automatic and condition-free EXCEPT:
  115. -    Microsoft Network may not distribute this software.
  116. -    All copies must be complete with all documentation files and copyright notices, and
  117.     there must be NO CHARGE beyond reasonable downloading / duplication fees.
  118.  
  119.     At some point there will be a charge for PatchDance.  The amount and time frame are
  120. not yet determined.  Fairly capable animation and rendering will definitely be available
  121. at minimal or no cost, and registered beta testers will receive very special consideration
  122. (another good reason to register.)
  123.     While it would be nice to stay free, it╒s just not realistic with a program of this size
  124. and complexity.  A huge number of manhours and no little money have gone into developing
  125. it (and bills eventually come due.)  In addition, high quality tech support is critical to the
  126. success of any 3D program, and that is expensive to provide, even on the Macintosh.  Also,
  127. history shows that freeware is simply not ╥taken seriously,╙ which is not acceptable to
  128. PatchDance╒s designers.
  129.     We will try to keep a cheap or free version available for 3D hobbyists, perhaps with
  130. limited import/export, model size, rendering resolution, tech support?   Suggestions
  131. are welcome: we want to help.
  132.  
  133. Change History
  134. ____________________________ 
  135. Changes from v0.4a0 -> v0.4a1
  136. Major (crashing) bugs fixed:
  137. -    Crash when: open file containing patches, delete a patch, close Project or quit.
  138. -    Crash when Pasting/Duplicating patched surfaces. 
  139. -    Crash when any operation attempted after undoing a Shape.
  140. -    Crash when extruding (converging) curved primitives.
  141. Minor bugs fixed:
  142. -    Reflect function: 3D objects were inverting along window axis.
  143. -    "Undo Deselection" and ╥Undo Duplicate╙ failed sometimes (operation dependent.)
  144. -    Spline subdivision failed after deleting a connected patch.
  145. -    Tool Palette occasionally went snaky when closing/opening new Projects
  146. -    Option-clicking a handle (when editing a corner) messed up the spline.
  147. -    Patching a spline surface failed exotically (extra/weird patches.)
  148. -    Text in the Revert dialog was wrong.
  149. General: 
  150. -    Improvements in patch subdivision and DXF file quality.
  151. -    Rewritten (repaired) Paste/Duplicate routine is MUCH faster.
  152. -    ╥Replicate╙ button removed from Extrude dialog - added ╥None (Replicate)╙ option to Spline Type popup instead.
  153. -    New "Export Surfaces Only" option (checkbox) in the DXF output dialog, for programs that choke on bare point/spline data (Strata Vision.)
  154. -    Statistics (General Palette) improved, not perfect or complete yet though.
  155. -    The Manual is now supplied in Adobe Acrobat¬ format, w/ hyperlinked  references and table of contents.
  156.  
  157.  
  158. ____________________________ 
  159. Changes from v0.4a1 -> v0.4b0
  160.  
  161. Major (crashing) bugs fixed:
  162. -    Crash when clicking the Camera or Focus with the Object Arrow (C) or Spline Arrow (B).
  163. -    Hang when using Lasso to deselect points (rarely).
  164. -    Crash when a Lathe operation undone and not redone.
  165.  
  166. Minor bugs fixed:
  167. -    Bad color updates when using the Preferences Dialog.  Background color shifting and the infamous black & white menubar bug are also (hopefully) fixed.
  168. -    Camera Roll & Zoom incorrect when opening a file.
  169. -    Save... not always deleting its temporary files.
  170. -    Operations involving Selection Center (not Centroid) went wrong sometimes
  171. -    Occasional weirdness when undoing Marquee operations.
  172. -    Frequent weirdness when adjusting spline handles in 3D
  173.  
  174. General: 
  175. -    Flat shaded preview.  FAST!  A separate tutorial (with a model file) is provided.
  176. -    Option-dragging either the Camera or Focus with the Arrow (A) moves BOTH at once (adjusts camera view without affecting the angle or field of view).
  177. -    New Windows:Locate & Center menu - easier model management.
  178. -    Snap Palette has been completely redone.  Loft dialog eliminated (converted to hierarchic menu).
  179. -    New (trial) interface feature for Tool/Operation dialogs:  can now switch between floating and standard window types.
  180. -    Padlock symbol is now a pencil meaning draw (ghost) with a red line thru it, meaning don╒t draw (don╒t ghost).  Should make more sense!
  181. -    Minor change to native file format.  Completely compatible but might affect saved Snap Palette settings, QuickColors.
  182. ____________________________ 
  183.  
  184.  
  185. ____________________________ 
  186. Changes from v0.4b0 -> v0.4b2
  187. (v0.4b1 renumbered to .b2 to fix file numbering error)
  188.  
  189. Major (crashing) bugs fixed:
  190. -    Several memory allocation problems with very large models.  Not reported.  New allocation system is much safer and faster.
  191. -    Various hangs and failures of Magnet Tool.  Fixed by code rewrite.
  192. -    Extrude crashed when troublemakers tried to use a single point.
  193. -    Memory errors with Scissors/Subdivide. (Actual crashes very rare.)
  194.  
  195. Minor bugs fixed:
  196. -    Moving things around sometimes loused up the selection bounds (used by Snap to Center, for example).
  197. -    Camera Window controls make more sense (more like real life).
  198. -    Total failure of Snap Palette (believed due to new compiler release).
  199. -    Got rid of annoying flicker when zooming or sizing windows.
  200. -    Tile Windows no longer destroys rulers/window controls.
  201. -    Undoing Object Selection works right.
  202. -    Various Camera View problems (adjusting the camera interactively).
  203. -    Undo/Redo Duplicate should work right now.  PLEASE report any problems with this (particularly screwed up Camera views).
  204.  
  205. General: 
  206. -    Camera View updates MUCH faster in shaded mode.  New Model menu item (Camera Options) provides several new features.
  207. -    Expert options work with Lathe and Extrude.  Both dialogs have been modified slightly.  I advise you to see the Manual before trying this!
  208. -    Numeric entry works better - should now be able to handle anything that makes sense, including empty fields (last valid value is used).
  209. -    Added final cr/lf to DXF files for programs that need it (VIDI).
  210. -    Checkboxes added to  Mover (D) and Rotator (R) dialogs to control the new Interactive Extrusion and Lathing functions.
  211. -    Save DXF File... removed from File menu - save/open is more general and streamlined, done via a popup in the Open/Save dialogs.
  212. -    File format has changed.  V0.4b2 handles this transparently, but saves ONLY in the new format.  Icons and filetypes have NOT changed.
  213. -    Clicking the Object (O) Tool Palette button pops up a menu of available shapes and modes, as an alternate to the dialog.
  214. -    Default buttons and hotkeys added to most modeless dialogs.  See the Manual (Interface) for details on this.
  215. -    Program tries to create a useful default Camera/Focus when first patch is created.
  216. -    Now supporting QuickDraw 3D!  The first serious (affordable) program to do so!
  217.  _________________________________ 
  218.  
  219.  
  220. ____________________________ 
  221. Changes from v0.4b2 -> v0.4b4
  222.  
  223. Major (crashing) bugs fixed:
  224. -    Several database errors. (Misplaced bits, sure enough crashers).
  225. -    Sneaky, widespread memory error when modifying VERY large models.
  226. -    Crash when subdividing partially selected objects (sometimes).
  227. -    Crash when smoothing large objects.
  228. -    Crash when making an extruded Cylinder w/ filled ends.
  229. -    Crash when quitting/switching applications with no open Project.
  230. -    Assorted crashes and hangs with QuickDraw 3D, especially with shapes.
  231.  
  232. Minor bugs fixed:
  233. -    The Pen Tool drew in the ghosting color in the Camera Window, drew 
  234.     points in the wrong color when attaching a new spline, and sometimes screwed up handles when attaching a new spline (3D Cursor was not reset properly to clicked point). 
  235. -    Show Clipboard works.  (Corrected stupid programmer error.)
  236. -    Missing pieces in extruded polygons.
  237. -    Join now works correctly in (hopefully) all cases.
  238. -    No more extra patches when filling meshes.
  239. -    Certain Undo╒s failed for the FIRST spline created in a Project.
  240. -    Sometimes failed to save correctly to an existing file.
  241. -    Many glitches in Subdivide (Patches) - major improvement.
  242. -    Going from Flat Shaded -> QD3D -> Flat Shaded mode left the camera window blank until model was changed and updated again.
  243. -    Float/Regular dialog conversion now uses command and/or option-double click in the title bar (to avoid conflicts with WindowShade).
  244. -    The General Palette now counts deleted patches correctly.
  245. -    Certain Undo╒s randomly deleted patches (Subdivide mainly).
  246.  
  247. General: 
  248. -    Complete rewrite of Hierarchy system:  fewer bugs; simpler (less buttons, drag and drop works); finally has a section in the Manual.
  249. -    You can now open and save PICT files.  Basic but useful later on.  QuickTime movies coming soon.
  250. -    DXF import is working.  Not fancy or fully tested (demand has been weak for this.)  Import is polygonal:  smoothing is up to the user.
  251. -    3DMF mesh export.  New method greatly improves DXF quality as well.
  252. -    Vastly improved Smooth function, with user-settable control value.
  253. -    Repeat Last menu command, lets you easily repeat menu commands that have no keyboard equivalents.  Fully user configurable menu keys soon.
  254. -    Rearranged Objects popup menu and added ability to set Filled mode.
  255. -    General Palette handles splines & patches better (either 0 or ?) - click the checkmark to get correct selected/hidden counts.
  256. -    New Camera Window controls - mode and lock status set by popup menus rather than icons to save space on 13╙ monitors.
  257. -    QD3D Mesh preview, w/ 2 quality levels.  Much faster than NURBS, slightly lower resolution and speed than standard shaded preview but better image quality (realistic shading).
  258. -    New online help:  single line now, larger ╥tutorial╙ palette coming soon.
  259. -    New documentation in HTML format.  Acrobat or word processor versions are still available for printing.
  260. -    Texture dialog now exists (though most controls are not installed).  Coments are requested.
  261.  
  262.  
  263. ____________________________ 
  264. Changes from v0.4b4 -> v0.4.2b4 (includes v0.4.1b4)
  265.  
  266. Major (crashing) bugs fixed:
  267. -    Crash when lathing large objects.
  268. -    Crash when saving imported DXF in DXF, 3DMF mesh formats.
  269.  
  270. Minor bugs fixed:
  271. -    DXF importer sometimes failed (did nothing).
  272. -    Resizing Camera Window in QD3D mode failed.
  273. -    Handles sometimes stuck when moving points with the Spline Arrow
  274.  
  275. General: 
  276. -    Model Windows recenter and rescale to fit imported models.
  277. -    FIT button added option to fit to all points as well as just selected.
  278.